Tùy chọn chung
Mô-đun này khả dụng trong các phiên bản sau 20260507
Một số API ui_element nhận bảng tùy chọn để chỉ định ứng dụng đích, số lượng kết quả, độ sâu phần tử con, kiểm tra tương tác và số bước thao tác.
Tùy chọn truy vấn
local options = {
pid = app.front_pid(),
max_level = 2,
max_elements = 200,
include_hit_state = true,
}
- pid
Số nguyên. Mã định danh tiến trình của ứng dụng đích. Khi bỏ qua, ứng dụng ở nền trước thường được dùng. - max_level
Số nguyên. Độ sâu mở rộng phần tử con. Dùng1hoặc2để giữ dữ liệu trả về ở mức nhỏ. - max_elements
Số nguyên. Số phần tử cấp cao nhất tối đa cần trả về. - fallback_children
Boolean. Thử đọc phần tử con khi danh sách thông thường rỗng. Giá trị mặc định tùy thuộc vào API. - include_hit_state
Boolean. Bao gồm các trường trạng thái tương tác. - hit_test
Boolean. Bật tra cứu tương tác bằng cách lấy mẫu màn hình. Kịch bản thông thường thường không cần tùy chọn này. - fallback_hit_test
Boolean. Thử tra cứu tương tác bằng cách lấy mẫu màn hình khi danh sách thông thường rỗng. - hit_test_spacing
Số. Khoảng cách lấy mẫu màn hình theo tọa độ logic. Mặc định là40.
Tùy chọn loại trừ thuộc tính
Có từ phiên bản 20261115. Chỉ dùng cho snapshot() và list_text_elements(). Tất cả đều là kiểu boolean, mặc định false và cũng áp dụng cho phần tử con. Khi không cần các trạng thái này, bật các tùy chọn loại trừ có thể giảm chi phí truy vấn và tăng tốc lấy ảnh chụp UI.
- exclude_visibility
Khi làtrue, bỏ qua truy vấn khả năng hiển thị và không trả vềisVisible. - exclude_map
Khi làtrue, bỏ qua kiểm tra thuộc tính bản đồ và không trả vềisMap; vẫn giữ các phần tử bản đồ. - exclude_hit_state
Khi làtrue, bỏ qua kiểm tra hit tại điểm trung tâm và không trả vềcanHit,hitVerified,hitTestPointvàhitTestPointLogical. Không thể dùng cùnginclude_hit_state = true.
Phạm vi phần tử, văn bản, tọa độ và quy tắc tìm bổ sung phần tử của hit_test / fallback_hit_test không thay đổi. Không loại trừ trường trạng thái nếu cần lọc theo trường đó.
Tùy chọn thao tác
- point
Bảng. Điểm tọa độ dùng để cuộn hoặc tra cứu tương tác, ví dụ{ x = 200, y = 700 }, tính bằng pixel vật lý. - x / y
Số nguyên. Giốngpoint, nhưng được đặt trực tiếp trong bảng tùy chọn. - steps
Số. Tham số bước cho thao tác cuộn, tăng hoặc giảm. Hiệu quả thực tế phụ thuộc vào điều khiển đích.
Mô tả
list_text_elements()giữ các giá trị mặc định thận trọng cho kịch bản cũ.find(),find_all(),snapshot()và các API thao tác thường phù hợp hơn với kịch bản mới.hit_testcó thể trả về các phần tử gần lớp trên cùng hiện tại hơn nhưng tốn nhiều tài nguyên hơn. Chỉ dùng khi truy vấn thông thường không tìm thấy mục tiêu.